Windows NT/2000 Build Environment for CVS Repository 'projects'

Microsoft's Visual C++ Developement environment should be installed.
Cygwin Version 1.0 (or higher) should be installed. These tools can be retrieved from mathengine's internal ftp site.

You should customise the Cygwin tools by creating a batch file and adding the following lines:

set MAKE_MODE=UNIX
set HOME=<PATH TO A FILE CALLED '.bashrc'>
set PATH=<PATH_TO_CYGWIN_BIN_DIR>;%PATH%
call <MICROSOFT_VISUAL_C++_DIR>\vc98\bin\vcvars32.bat
bash

The above 'PATH' statement is not strictly necessary but does resolves issues where Microsoft and UNIX commands (ex. 'find') have the same name.

The text file '.bashrc' must contain the following text at least:

#!/bin/sh

# build environment variables needed (sometimes)
export CVSROOT=:pserver:anoncvs@cvs.mtl.mathengine.com:/proj/projects

Start Cygwin using the batch file you just created

Notes

When refering to a 'PATH' in your batch file ensure you use the '8.3' equilvalent i.e.
- '...\Program Files\MyApplication\bin' becomes '...\Progra~1\MyAppl~1\bin' or possibly '...\Progra~1\MyAppl~2\bin', check using the native command shell.
The space and the '\' characters have special meaning in Cygwin. This means that when specifying a PATH in your '.bashrc' file:
- '...\Program Files\MyApplication\bin' becomes '...\\Program\ Files\\MyApplication\\bin'
Basically the '\' character 'escapes' any special characters.

Notes on using Windows 9x

The Makefile's probably won't work due to the generally dumbness of this OS but here are some pointers anyway:

GNU Cygwin Beta tools should be installed. These tools can be retrieved from mathengine's internal ftp site.
Microsoft's Visual C++ Developement environment should be installed.
Perl should be installed. Perl can be retrieved from here.

You should customise the GNU Cygwin tools by adding the following lines to '<CYGWIN_DIR>/cygwin-<VERSION>/cygnus.bat':

set MAKE_MODE=UNIX
set HOME=<PATH TO A FILE CALLED '.bashrc'>
set PATH=<PATH_TO_CYGWIN_BIN_DIR>;%PATH%
call <MICROSOFT_VISUAL_C++_DIR>\vc98\bin\vcvars32.bat
bash

The text file '.bashrc' must contain the following text at least:

# build environment variables needed (sometimes)
PERL=<PERL_DIR>
CVS=<CVS_DIR>
CVSROOT=:pserver:anoncvs@mtlcvs.mtl.mathengine.com:/proj/projects

export CVSROOT
export PATH=${PATH}:${CVS}:${PERL}

Start the Cygwin tools and type:
```
cd /
mkdir tmp
mkdir bin
cp `find -name sh.exe` /bin
```
- If the previous command fails to copy 'sh.exe' to /bin try executing it again in '//c', '//d', '//e' etc.
- Notice the use of 'back quotes' in this command.
If you get a message like 'out of environment space' add the following line to your 'config.sys':
```
shell=<SYSTEM_ROOT>command.com /e:2048 /p
```
When refering to a 'PATH' in a batch file (ex. cygnus.bat) ensure you use the '8.3' equilvalent i.e.
- '...\Program Files\MyApplication\bin' becomes '...\Progra~1\MyAppl~1\bin' or possibly '...\Progra~1\MyAppl~2\bin', check using the native command shell.
The space and the '\' characters have special meaning in Cygwin. This means that when specifying a PATH in your '.bashrc' file:
- '...\Program Files\MyApplication\bin' becomes '...\\Program\ Files\\MyApplication\\bin'
Basically the '\' character 'escapes' any special characters.